home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / program / assembly / newstart.readme < prev    next >
Text File  |  1995-09-30  |  4KB  |  108 lines

  1. Short:    Very powerful startup code for assembler.
  2. Author:   Kenneth C. Nilsen / Digital Surface (soon: djdoom@digsur.wws.no)
  3. Uploader: E64@Cyber.hibo.no / G.Ingvaldsen / Bodoe BBS
  4. Type:     dev/asm
  5.  
  6.  
  7. Requires kickstart 1.2+, any chip and configuration.
  8.  
  9.  
  10. Startup.asm
  11. ===========
  12.  
  13. $VER: Startup_asm 3.4 (5.9.95)
  14.  
  15. Copyright  1995, by Kenneth C. Nilsen.
  16. All rights reserved.
  17.  
  18. The best startup code you find for assemblers.
  19. This source is free.
  20.  
  21. Any kickstart (1.2+), any chip and configuration will do.
  22.  
  23.  
  24.  
  25. WHY USE THIS CODE?
  26. ==================
  27.  
  28.      1) It makes your programs safe from crashing on system that has lower
  29.         processor configuration than you require. An error message is given
  30.         and the program will exit without executing any of your code.
  31.      2) It prevents your program to crash if you start from Workbench/icon.
  32.      3) Expands your assembler with 10 more commands!
  33.      4) Very easy to open libraries. One line opens a library. Even error
  34.         messages are given if any of the libraries can't be opened.
  35.      5) It enables easy argument parsing where one argument is given to you
  36.         one by one.
  37.      6) Very easy to implement in your sources, just one include (itself).
  38.      7) Supports the 68060 processor (tested).
  39.      8) Source is completly safe. Contributed to the public domain by 12
  40. years
  41.         experience with programming.
  42.      9) You don't need any external includes to make this startup code work.
  43.     10) Learn how to deal with these situation by study the source.
  44.     11) Experiment with the source and make a startup code for your needs.
  45.     12) By using the internal NextArg macro you can have more UNIX like
  46.         option command lines for your programs. The ReadArgs() function is
  47.         limited in that manner.
  48.     13) Helps you setting the right return code at exit.
  49.     14) A demo program and source are following this archive.
  50.  
  51.  
  52.  
  53. NEW FEATURES
  54. ============
  55.  
  56. 3.4:
  57.         - Added <Return> macro. Use it like "Return 0" and it puts the return
  58.           code in D0 and makes a RTS automatically. Added info to doc and
  59.           startup example. Optimized some code.
  60.  
  61.           Added comments in the Startup.asm source! :)
  62.  
  63.           Added *n (newline) feature in argument parsing. Use this like:
  64.           > Test "This is a test*nto see newline in *"qvotes*".". This will
  65. be:
  66.           > This is a test
  67.           > to see newline in "qvotes".
  68.  
  69.           Included a sample header source.
  70.  
  71. 3.3beta:
  72.         - Is now bug free! :) Only thing to change now is to read icon args/
  73.           tooltypes from Workbench due to a main release :)
  74.  
  75. 3.2beta:
  76.         - Added 68040 FPU options. Use:
  77.           MathProc = 68881/68882 or 68040 to set FPU. 0=no FPU.
  78.  
  79.  
  80.  
  81. BUG FIXES
  82. =========
  83.  
  84. 3.3beta:
  85.         - an enforcer hit fixed (BYTE READ FROM 0). Occured when starting
  86. from
  87.           icon with no argument. Never was dangerous, but still nice to have
  88.           it all clean :)
  89.  
  90. 3.2beta:
  91.         - there was a bug testing for 68060. If you had a 040 with 040FPU
  92. this
  93.           allowed you to run programs assembled for 060.
  94.         - a bug where reported about the Version and TaskName macros. These
  95.           work fine with AsmOne, but both DevPac and Barfly can not handle
  96.           spaces between words even if they are in qvotes. Sorry, can not do
  97.           something about this (I think) so write version strings manually
  98. and
  99.           use TaskName with underscores instead of spaces...
  100.         - an enforcer hit (BYTE READ FROM 0) where reported when started from
  101.           workbench. Working on the problem, but no danger... :)
  102.  
  103. 3.1beta:
  104.         - Implemented an unfinished Startup.asm file in the 3.0 archive.
  105.         - Expanded the NextArg macro to solve *" situations in arguments.
  106.         - Added buffercount for output strings. This caused misunderstandings
  107.           and people reported bugs. Not a bug, but not a good presentation :)
  108.